SHOWCUE CONNECTOR — SNELSTART
QLab 5, vMix en PowerPoint | Windows

1. OPENEN
   Download zonder login op https://showcue.nl/connector.
   Pak de ZIP uit en open ShowCue-Connector.exe.
   Python is niet nodig. Deze preview is niet digitaal ondertekend; Windows kan
   een melding tonen over een onbekende uitgever.

2. KOPPELEN AAN JE SHOW
   Open in ShowCue je show → Show tools → Companion → Video playback.
   Je kunt Video playback ook rechtstreeks onder Show tools openen.
   Geef je pc in de juiste connectortab een naam en klik Koppelen met ShowCue.
   Voer de tijdelijke code in bij Accept a device in ShowCue (10 minuten geldig).
   Controleer de pc-naam, kies de bron en accepteer. De sleutel wordt automatisch
   ingesteld. Klik daarna in de connector op Verbinden.

3. QLAB 5
   QLab draait op een Mac; de connector mag op een Windows-pc op hetzelfde LAN.
   Zet in QLab onder Workspace Settings → Network → OSC Access de View-toegang
   aan. Gebruik desgewenst een passcode met alleen View-rechten.
   Vul in de connector het IP-adres van de Mac en poort 53000 in.
   Bij één open workspace mag het workspaceveld leeg blijven. Vul anders de
   exacte naam of ID in. Een leeg cue-veld volgt alle actieve videocues;
   een ingevuld cue-nummer volgt alleen die cue. Klik op Verbinden.

4. VMIX
   Zet in vMix onder Settings → Web de Web Controller/API aan.
   Vul het IP-adres van de vMix-pc en poort 8088 in.
   Gebruik 127.0.0.1 als vMix op dezelfde pc draait.
   Laat het inputveld leeg voor de hoofd-Program-input, of vul een vaste
   Video-input in. Klik op Verbinden. Beide tabs kunnen tegelijk verbinden.

5. COUNTDOWN TONEN
   De titel en resterende tijd verschijnen in Showcaller.
   Kies bij Display screens het element Video playback voor een groot scherm.
   Herlaad een al open Showcaller na de eerste koppeling.
   Laat de connector open tijdens de show. Windows bewaart sleutels en wachtwoorden
   versleuteld voor jouw account, ook na afsluiten en updates. Vergeten wist de
   lokale koppeling; Revoke in ShowCue trekt de toegang in.

GOED OM TE WETEN
   - Kies Open playback monitor voor een apart meekijkscherm met grote countdown.
     Gebruik Fullscreen om dit scherm beeldvullend te maken (geen videobeeld).
   - Pauze, springen en stoppen volgen de speler. Bij een loop telt de tijd af
     tot de volgende herhaling. Zonder bekende duur toont een loop ∞.
   - De connector leest elke 200 ms en stuurt updates via een permanente
     WebSocketverbinding. Speler en netwerk bepalen de werkelijke vertraging.
   - Geen vaste tijdcorrectie: de countdown volgt de gemeten stand en ouderdom.
     Dit is geen frame-nauwkeurige trigger.
   - Zonder verse gegevens verdwijnt de countdown na circa zes seconden.
   - QLab/vMix moeten via het lokale netwerk bereikbaar zijn; ShowCue via HTTPS en WSS.
   - Voor de connector is geen lokaal HTTPS-certificaat nodig.
   - Gebruik één connector per bron en show.
   - vMix Video List wordt nog niet ondersteund. Kies bij overlays of samengestelde
     outputs de onderliggende losse Video-input. HDMI/NDI levert geen filmduur.
   - Test eerst met de echte spelers voordat je deze preview live inzet.

PROBLEMEN?
   Geen verbinding: controleer IP-adres, poort, firewall en internet.
   Toegang geweigerd: controleer de ShowCue-sleutel of QLab/vMix-passcode en klik
   opnieuw op Verbinden. Een ingetrokken sleutel werkt direct niet meer.

Korte online handleiding: https://showcue.nl/handleiding/playback
UPDATES (Windows-programma, vanaf 2.2.0)
Stop alle verbindingen en klik onderaan op Controleren op updates.
Vul in de geselecteerde tab het serveradres in. Vanaf 2.3.0 is geen sleutel nodig.
Bevestig de update: downloaden, controleren en herstarten gaan automatisch.
Instellingen en sleutels blijven behouden via tijdelijke Windows-versleuteling.
Bij versie 2.1.0 en ouder is nog eenmalig een handmatige download nodig.

POWERPOINT (Windows, connector 2.1.0+)
Start de connector op de Windows-pc met PowerPoint.
Koppel via een tijdelijke code en accepteer in ShowCue voor de bron PowerPoint.
Start de diavoorstelling en klik in de PowerPoint-tab op Verbinden.
Start één diavoorstelling. Showcaller toont Slide X of Y (volledige decknummering).
Dit deelt alleen naam en diastand, geen live beeld of notities.
